package cn.tedu.tmall.front.content.service;

import cn.tedu.tmall.common.consts.data.ContentConsts;
import cn.tedu.tmall.common.pojo.authentication.CurrentPrincipal;
import cn.tedu.tmall.common.pojo.vo.PageData;
import cn.tedu.tmall.front.content.pojo.param.ArticleCommentAddNewParam;
import cn.tedu.tmall.front.content.pojo.vo.CommentListItemVO;
import org.springframework.transaction.annotation.Transactional;

/**
 * 处理评论数据的业务接口
 *
 * @author java@tedu.cn
 * @version 3.0
 */
@Transactional
public interface ICommentService extends ContentConsts {

    /**
     * 发表文章评论
     *
     * @param currentPrincipal          当事人
     * @param remoteAddr                IP地址
     * @param articleCommentAddNewParam 新增的评论数据
     */
    void addNewArticleComment(CurrentPrincipal currentPrincipal, String remoteAddr, ArticleCommentAddNewParam articleCommentAddNewParam);

    /**
     * 根据文章查询评论列表，将使用默认的每页记录数
     *
     * @param articleId 文章的ID
     * @param pageNum   页码
     * @return 评论列表
     */
    PageData<CommentListItemVO> listByArticle(Long articleId, Integer pageNum);

    /**
     * 根据文章查询评论列表
     *
     * @param articleId 文章的ID
     * @param pageNum   页码
     * @param pageSize  每页记录数
     * @return 评论列表
     */
    PageData<CommentListItemVO> listByArticle(Long articleId, Integer pageNum, Integer pageSize);

}
